home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Mission 3
/
Mission 3.zip
/
Mission 3.iso
/
divers
/
pacifist
/
pcst048
/
docs
/
pacifist.fra
< prev
next >
Wrap
Text File
|
1998-01-24
|
65KB
|
1,478 lines
ץ³∞∞∞∞³ץ
ף§ õ ∧ף
ף Ø ף
ץ³∞∞∞∞³ץ ץ³∞∞∞∞³ץ ץ³∞∞∞∞³ץ ץ³∞³ץף ף ףץ³∞³ץ ץ³∞∞∞∞³ץף∞∞∞∞ף
ף§ õ ∧ا õ ∧ا õ ∧ا ∧ף ף ף§ ∧ا Ø ∧ף ףץץ
ף Ø ף Ø ף Ø ף ף ף ף ף ∞∞∞∞ף ף
ף ף ף∞∞∞∞∞ ף ף∞∞∞ף∞∞∞∞∞ף ף∞∞∞ף∞∞∞∞∞ף∞∞∞∞ף ף ף∞∞∞ף
ף ף ף ף ף ף ף ף ף∞∞ ף ף ף ף ף ף
ף ף ף ף ף ף ף ף ף ף ף ף ף ף ף
ף ף ∧ا ף ∧ا ף ∧Ø ף ף ף ا ף ∧Ø ף ף
ף ץץ³∞ ∞³ץץץץ³∞ ∞³ץץץץ³∞ףץץץץץØץץץץØ ףץץץץץף∞³ץץץץ³∞ף ף ף
------ף ף -------------------------------------------- sns -ף§ ף ∧Ø-----
õ õõõ ףץץץץØ õõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõõ ∞³ץץץץ³∞ õõõ
PaCifiST v0.48
~~~~~~~~~~~~~~
programmé par Frederic Gidouin
(frederic.gidouin@hol.fr)
Emulation YM2149 & driver
Soundblaster par Arnaud Carré
(leonard@mygale.org)
(c) 1996-1998
Dernière Mise à jour: Samedi 24 Janvier 1998
-------------------------------------------------------------------------------
TABLE DES MATIERES
0. Changements dans ce document
1. Introduction
1.1 Qu'est-ce que PaCifiST?
1.2 Pourquoi devrais-je l'utiliser?
1.3 Caractéristiques
1.4 Développements futures
1.5 Combien ça coûte?
2. Installation
2.1 Matériel Requis
2.2 Quelques concepts utilisés dans PaCifiST
2.2.1 Un mot sur le Moniteur
2.2.2 L'émulation Vidéo
2.2.3 Les modes de vitesse ("Speed Modes")
2.2.4 L'émulation des lecteurs
2.2.5 Le son
2.3 Avant de démarrer l'émulateur...
3. Configuration
3.1 Référence des directives du fichier INI
3.1.1 Section "System" (Système)
3.1.2 Section "Screen" (Ecran)
3.1.3 Section "Debug" (Debogage)
3.1.4 Exemple de fichier PACIFIST.INI
3.2 Paramètres de la ligne de commande
3.3 Configuration depuis le Moniteur
3.4 L'écran de sélection de disquette
3.5 L'écran des ports joysticks
4. Divers
4.1 Quelques Conseils
4.2 Le VBE 2.0
4.3 Images de disquettes
4.4 Correspondances pour le clavier
4.5 Captures d'écran
4.6 Sauvegarde de jeux
4.7 Enregistrement de musiques .YM (PARTIE NON ENCORE
4.7.1 Utilisation TRADUITE EN
4.7.2 Informations Techniques FRANCAIS)
4.8 Detection & Utilisation de PaCifiST
4.9 Freezing/Unfreezing [*NOUVEAU*]
5. Le Moniteur
5.1 L'écran du moniteur
5.2 Les Commandes du moniteur
5.3 Evaluateur d'expressions [*NOUVEAU*]
6. Ressources & Remerciements
6.1 Programmes connexes
6.1.1 Autres Pages Web
6.1.2 Utilitaires
6.2 Ressources
6.3 Remerciements
6.4 Pour me contacter
-------------------------------------------------------------------------------
0. Changements dans ce document (depuis la version 0.47)
========================================================
Nouvelles directives INI: vbemode, midi
Moniteur: commands e,fz,uz,bar,baw
évaluateur d'expression
touche MONO/COLOR
Freezing/Unfreezing
MIDI OUT, shifter STE
1. Introduction
===============
1.1 Qu'est-ce que PaCifiST?
---------------------------
PaCifiST est un émulateur Atari ST pour PC. Il s'agit d'un
émulateur logiciel, ce qui veut dire qu'il ne requiert aucune carte
d'extension avec des composants du ST, votre PC suffit.
Il vous permettra d'utiliser de nombreux logiciels Atari ST sur votre PC.
1.2 Pourquoi devrais-je l'utiliser?
-----------------------------------
Si vous avez été un possesseur d'Atari ST, la réponse c'est: LA NOSTALGIE!
C'est vraiment sympa de pouvoir ré-utiliser ses vieux programmes.
De nos jours, il y a des jeux pour PC d'une taille gigantesques, avec des
graphismes & des sons incroyables. Mais à part quelques uns, ils sont
généralement vite lassants et n'ont pas "d'âme".
L'Atari ST n'est pas le seul ordinateur possédant de bons jeux (j'apprécie
également le C64 et l'Amiga) mais si vous avez déjà joué à Super Sprint,
Stunt Car Racer, Dungeon Master ou Colonial Conquest... Alors vous avez une
idée de ce qu'est un BON JEU.
Bien sur, il n'y a pas que des jeux sur Atari ST! Cette machine était par
exemple largement utilisée par les professionnels de la musique, et on peut
trouver à peu près tous les types de logiciels
1.3 Caractéristiques
--------------------
PaCifiST émules les composantes suivantes d'un Atari ST normal:
Motorola 68000 L'émulation du 68000 est écrite entièrement en
assembleur Intel. Tous les aspects du processeurs sont
respectés, à l'exception des instructions en BCD
(incorrectes). Le prefetch est émulé, pour peu qu'on
utilise l'option "pref" du moniteur. Dans la mesure
où cela ralentit considérablement la vitesse globale
de l'émulateur, il est conseillé de n'activer cette
option uniquement pour passer certaines routines
foireuses. L'émulation du 68030 arrivera dans un
futur plus ou moins lointain.
Shifter (Vidéo) Les 3 modes graphiques standards du ST sont supportés.
Vous pouvez choisir entre une émulation monochrome
(haute résolution) ou couleur (basse et moyenne
résolutions. Toute l'émulation vidéo est réalisée 100%
en assembleur.
Certains effets spéciaux (changement de palette,
"rasters" sont possibles, à partir du moment où vous
utiliser un driver VBE2.0 et que vous passiez en mode
LINE (ligne) d'émulation vidéo. Un autre mode possible
(depuis la version 0.44) est le mode MIXED: Il permet
en plus le changement de résolution en plein milieu
d'un écran.
Depuis la version 0.45, PaCifiST est aussi capable
d'émuler des résolutions étendues, mais cela ne
marchera, sous certaines conditions, qu'avec des
applications systèmes.
Pour le moment, seuls les overscans bas sont rendus.
PaCifiST 0.48 emuler le shifter du STE (cf directive
INI ste). [*NOUVEAU*]
6301 (Clavier) Ce processeur est utilisé pour la gestion du clavier,
de la souris, du joystick et de l'horloge interne dans
un ST réel. Le comportement exact de cette puce n'est
pas émulé (cela prendrait trop de temps), une simple
simulation est suffisante et se précise à chaque
nouvelle version de l'émulateur. Une souris PC est
nécessaire. Si aucun joystick PC n'est détecté au
démarrage (ou si vous l'avez inhibé dans PACIFIST.INI),
une émulation du joystick ST au clavier est proposée.
YM-2149 (Son) Cette puce sonore est émulée si une carte son supportée
est reconnue (SB & GUS). L'émulation YM est réalisé
par Arnaud Carré, également auteur de STSound. Les
samples STF sont également + ou - bien restitués.
MFP Les interruptions VBL, FDC, ACIA, TIMER C sont
correctes ainsi que les timers A, B & D en "events
count mode" (mode de comptage d'évenements). La HBL
n'est pas bien précise, mais c'est aussi le cas sur
un vrai ST.
FDC / HDC PaCifiST utilise 3 niveaux pour l'émulation disque:
Gemdos, Bios et matérielle. Le niveau Gemdos permet
l'utilisation de vos disques durs/CD-ROM PC sous
Atari. Pour les émulations Bios et matérielle, des
"images" de disquettes sont utilisées pour simuler
de vraies disquettes. Vous pouvez également utiliser
votre lecteur de disquette PC (CE N'EST PAS DU TOUT
RECOMMANDé!!!)
Depuis la v0.45, le formatage est possible, mais il
est simulé et nécessite que l'image de disquette ait
la même géométrie (paramètres logiques) que le format
voulu par l'application.
I/O Ce qui est envoyé vers le port parallèle est écrit
dans le fichier PARALLEL.OUT.
Le port série n'est pas encore fonctionnel.
MIDI [*NOUVEAU*] PaCifiST 0.48 dispose d'une emulation
MIDI OUTPUT très primitive via le port d'une
Soundblaster. Pour se faire, vous devez avoir "midi"
configuré dans le fichier INI, mais alors l'émulation
de la puce sonore est désactivée. Testé avec le
jeu "Eco".
Blitter Le blitter du STE est à présent émulé
1.4 Développements Futurs
-------------------------
Il reste de nombreuses choses à faire, ainsi que d'autres à corriger.
La liste des choses à faire est comme suit, sans ordre précis:
- meilleurs sons digitalisés STF
- corriger les monceaux de bogues restants
- Son DMA STE
- Accélérer l'émulation du 68000 encore un peu
- Overscans & Syncscrolls
- Meilleur moniteur (évaluateur d'expression, points d'arrêt
conditionnels...)
- Port Série qui marche
- Programme de transfert Atari<->PC
- Une option pour enregistrer/restaurer l'état du ST émulé
- Emulation 68030
Ecrivez-moi si vous avez d'autres idées réalisables.
D'autres améliorations sympa sont possibles:
- Emulation native du processeur 6301
- Support Midi total
- Emulation du FDC avec les lecteurs de disquettes PC (bof!!!)
Mais je n'ai ni les docs, ni le courage de le faire pour le moment.
1.5 Combien ça coûte?
---------------------
Avant, ce programme était Shareware (partagiciel). A présent il est
Giftware (On peut traduire par doniciel).
========
Vous êtes libres et encouragés de le diffuser autour de vous, à partir du
moment où vous ne gagnez pas d'argent se faisant.
...MAIS vous êtes hautement encouragés ^_^; de contribuer... Je passe
beaucoup de temps sur ce projet et aimerai beaucoup recevoir quels que type
de remerciements que se soient. M'envoyer une certaines sommes d'argent
serait fantastique, et me permettrait de payer ma note de téléphone. Sinon,
vous pouvez m'envoyer une simple carte postale, un *vieux* film de SF,
un CD fait maison ou... Un bière locale!
Je déteste les programmes sharewares bridés, je ne veux pas en arriver la. En
retour j'espère juste que ceux qui en ont les moyens voudront bien contribuer
d'eux mêmes.
Merci a tous ceux qui l'ont d'ors et déjà fait.
2. Installation
===============
2.1 Matériel Requis
-------------------
PaCifiST est conçu pour un environnement DOS. Il marchera à priori mieux depuis
le DOS, mais se satisfera d'une sessions DOS sous Windows 3.11, 95 ou NT. On
m'a dit qu'il fonctionnait également sous OS/2 (assurez-vous juste que l'option
MOUSE_EXCLUSIVE_ACCESS soit OFF), mais pas sous DosEmu depuis Linux.
La configuration MINIMALE sur laquelle vous devriez utiliser ce programme est
un 486DX-100. Il marchera avec moins que ça, mais ne vous attendez pas alors
à des prouesses. Je développe PaCifiST sur un AMD 586-133 (environ un P75),
et la vitesse est généralement supérieure à celle d'un ST de base à 50
images/secondes, le son émulé à 22Khz, avec la plupart des jeux. Bien sur
certaines routines (plasma) ralentissent plus que d'autres l'émulation.
PaCifiST nécessite environ 1.5 Mo de mémoire lui même, à quoi il faut
ajouter la taille de mémoire vive ST que vous voulez. Avec 8Mo de mémoire,
vous aurez au mieux un Atari ST avec 6Mo.
Une souris est NECESSAIRE. Vous pouvez choisir entre un driver intégré (souris
branchée sur le port série seulement) ou un driver standard que vous aurez
pris soin de démarrer. Le driver intégré ne fonctionne pas sous Win95, je
ne l'ai fait que pour corriger un bug rencontré par quelques personnes.
Si PaCifiST ne détecte pas de joystick, il utilisera les touches flèches
de votre clavier (quand la diode NumLock/VerrNum (Pavé Numérique) est
éteinte seulement) pour en simuler un. Vous pouvez afficher l'écran de
l'émulation joystick avec F4 depuis le moniteur.
Une carte son compatible soundblaster ou GUS est nécessaire si vous désirez
entendre quelque chose.
En plus de tout ça, vous devez impérativement posséder un fichier "dump"
d'un TOS (le système d'exploitation en ROM) ST. Lancez le programme ST
joint DUMP_TOS.PRG (dans le répertoire STFILES) pour sauver son TOS sur
disquette.
PaCifiST doit absolument être exécuté depuis son répertoire, qui devra
contenir le fichier PACIFIST.INI (fichier texte de configuration) et PATCH.H68
(qui contient un peu de code 68000 nécessaire à l'émulation Gemdos).
2.2 Quelques concepts utilisés par PaCifiST
-------------------------------------------
Cette section donne quelques explications sur des concepts qu'il est
souhaitable de comprendre pour exploiter au maximum l'émulateur.
2.2.1 Un mot sur le Moniteur
----------------------------
Par defaut, quand vous démarrer PaCifiST, vous atterrissez sur l'écran du
moniteur. Pour lancer l'émulation proprement dite, vous devez taper "g" (go)
et appuyer sur ENTREE. Vous pouvez rappller cet écran à tout moment en
appuyant sur la touche qui est entre ECHAP et TAB (souvent un petit 2). Vous
aurez besoin de passer par là pour quitter l'émulateur, réinitiliser l'Atari,
choisir un mode vidéo de restitution ou d'autres options.
IMPORTANT: Parfois, quand vous rappelez l'écran du Moniteur, il se peut que
le clavier ne réponde pas bien. En ce cas, pressez simultanément sur les
touches SHIFT, ALT & CTRL.
La commande "x" permet de revenir au DOS.
Reportez-vous à la section qui résume les commandes du Moniteur pour plus
d'explications.
2.2 L'émulation Vidéo
---------------------
Il existe 4 différentes façons d'émuler la vidéo. Néanmoins, seul la
basse résolution est affecté.
Le premier mode (utilisé par défaut) est appelé le "Screen-Oriented" (orienté
écran), car tout l'écran de l'Atari ST est affiché d'un seul coup. De ce fait,
une seule palette (16 couleurs) est utilisable et aucun effet spécial n'est
possible. C'est le mode idéal pour se servir d'applications GEM, il est aussi
le plus rapide.
Le second mode est appelé "Line-Oriented" (orienté ligne), et cette fois-ci
chaque ligne de l'écran Atari est construite à la fois. C'est le mode idéal
pour les jeux et les démos car il autorise de nombreux effets spéciaux.
Le troisième mode est le "Mixed mode" (mode mixte) et requiert un driver VBE
proposant une résolution de 640x400x256 en mode linéaire. Identique au mode
"orienté ligne" mais il autorise en plus le changement dynamique de résolution
en plein milieu d'une image (comme dans les jeux d'aventures de Magnetic
Scroll & de Level 9, et dans la Calimero Demo par exemple).
Le dernier mode (nouveau dans la version 0.45) est le "custom mode" (mode
personnel) et lui aussi nécessite une résolution VBE de 640x480x256. TOUT CELA
EST EXPERIMENTAL, ne l'utilisez que depuis le bureau du GEM et avec le TOS2.06.
Vous ne pouvez pas choisir ce mode une fois l'émulateur lancé, il faut le faire
au démarrage (option RENDER (rendu) du fichier INI ou en paramètre de la ligne
de commande).
Mode orienté écran (Screen-Oriented mode)
- ne permet pas d'effet spécial
+ fonctionne très bien sous Windows même fenêtré)
+ rapide
+ marche sur toute les configurations
Mode orienté écran (Line-Oriented mode)
- plus lent
- driver VBE2.0 recommandé
- fonctionne SEULEMENT en plein écran sous Windows
+ différentes résolution PC (320x200, 640x480...)
+ capable de gérer les changements de palette (rasters),
overscan bas (avec plus de 200 lignes).
Mode mixte (Mixed-Mode)
- bien plus lent
- nécessite un driver VBE2.0 avec une résolution de 640x480x256
ou 640x400x256.
- ne marche qu'en plein écran sous Windows
+ capable d'émuler plus ou moins bien les changement de palette
et de résolution dans l'image.
Vous pouvez passer d'un de ces modes d'émulation vidéo à un autre facilement
(touche F1 sous le moniteur).
IMPORTANT: le mode "orienté ligne" est désactivé en haute et moyenne
résolution. Le mode Mixte est désactivé en haute résolution.
Mode personnel (Custom-Mode):
- *très* lent
- nécessite un driver VBE2.0 avec une résolution de 640x480x256.
- ne marche qu'en plein écran sous Windows
- une fois choisi ce mode, vous ne pouvez plus changer de
mode sans quitter l'émulateur.
+ extension de la résolution ST à 640x480 en 16 couleurs.
d'autres résolutions seront peut-être ajoutées dans le futur.
2.2.3 Les Modes de Vitesse (Speed Modes)
----------------------------------------
La version 0.4 a vu l'arrivée de 2 modes de vitesse d'émulation: ST et MAX. Le
mode par défaut est le ST-speed (vitesse ST): Meme avec le plus rapide des
Pntium, la vitesse n'excédera jamais celle d'un ST à 8Mhz. C'est absolument
nécessaire pour certains programmes. L'autre mode, MAX-speed (vitesse maxi)
fait que l'émulateur se synchronise avec la vitesse du PC. Néanmoins ce mode
n'est compatible qu'avec des applications systèmes.
Passer d'un mode de vitesse à l'autre en cours d'émulation n'est PAS RECOMMANDE,
mieux vaut le faire avant.
2.2.4 L'émulation des lecteurs
------------------------------
PaCifiST propose 3 façons d'émuler les unité de stockage.
- LECTEUR DE DISQUETTES PC (A:)
J'ai ajouté ce mode quasi-contraint par bon nombre de demandes.
Ce n'est PAS RECOMMANDE!!! Il subsiste de nombreux problèmes, notamment
la détection de changement de disquette & la protection. Si la
directive <pcdrive> (lecteur PC) est utilisée au démarrage et qu'aucune
image de disquette n'est choisie pour le lecteur ST A:, alors PaCifiST
bootera sur le lecteur physique du PC. Toutefois, j'insiste: Utilisez
plutôt des images de disquettes... ^_^;
La clause PCDRIVE semble donner de meilleur résultat sous Windows 95
que sous DOS.
- IMAGES DE DISQUETTE (Disk Images):
Il s'agit d'un fichier qui contient à la suite tous les secteurs d'une
disquette. Pour les programmes émulés, il est similaire à une vraie
disquette insérée dans un lecteur. Les images de disquette fonctionnent
avec tous les programmes, même ceux qui utilise directement le
contrôleur de disque (FDC). PaCifiST reconnaît les images de disquette
à leur extension ".ST".
Vous pouvez choisir 2 images au démarrage de l'émulateur avec la
directive "IMAGE=", ou en cours d'émulation depuis l'écran de Sélection
de disquette (DISK SELECTION SCREEN).
Depuis la version 0.41, PaCifiST peut aussi utiliser des fichiers MSA.
- REPERTOIRES MONTéS (Mounted Directories):
Cela ne marchera que pour les programmes utilisant le GEMDOS pour leur
accès aux fichiers. Cette méthode vous permet de "monter" des
répertoires de votre PC comme des unités Atari. Par exemple, si vous
montez "D:\ATARI" sur le lecteur C: de l'Atari au démarrage, les
programmes lancés depuis l'émulateur verront le répertoire D:\ATARI
et tous ses sous-répertoires comme étant sur un lecteur C:.
Vous pouvez très bien monter des partitions entières, mais ce n'est
pas conseillé: Vous avez plutôt intérêt à n'utiliser qu'un répertoire
ou deux. De cette façon, même en cas de gros plantage, aucun de
vos fichiers PC ne seront affectés.
Vous ne pouvez pas changer l'affectation de répertoire montés une
fois PaCifiST lancé, ce n'est possible qu'au démarrage.
2.2.5 Le Son
------------
Les sons digitalisés du STF sont très mal rendu pour l'instant (mais ça
dépend beaucoup de la routine qui les joue). Vous pouvez supprimer cette
émulation dans le fichier INI ou avec la touche F5 sous le moniteur.
Les cartes sons supportés sont la Soundblaster et la Gravis Ultrasound. Des
drivers pour d'autres cartes ne sont pas prévus.
L'émulateur tentera d'abord de détecter une GUS, puis une Soundblaster...
SOUNDBLASTER
============
PaCifiST n'essayera pas de la trouver tout seul, mais se basera sur la
variable d'environnement BLASTER. Avant de démarrer l'émulateur, assurez-vous
qu'elle est bien définie. Reportez-vous à la documentation de votre carte
sonore si vous n'y parvenez pas. Si vous connaissez les paramètres, sous
DOS tapez:
SET BLASTER= Axxx Ix Dx
Axxx étant la valeur du Port. Par exemple A220
Ix étant le numéro d'interruption. Par exemple I7
Dx étant le canal DMA. Par exemple D1
GRAVIS ULTRASOUND
=================
Comme pour la SB, la variable d'environnement ULTRASND doit être définie.
SET ULTRASND= ppp,d,d',i,i'
Où ppp est la valeur du port (220,240...)
Où d est le canal DMA
Où i est le numéro d'interruption
2.3 Avant de démarrer l'émulateur
---------------------------------
PaCifiST est configuré par l'intermédiaire d'un fichier texte: "PACIFIST.INI".
Vous pouvez l'éditer avec n'importe quel éditeur (l'EDIT du DOS, le NOTEPAD de
Windows) pour modifier le comportement de l'émulateur. Certaines options
peuvent aussi être spécifiées en paramètre sur la ligne de commande.
Ce document contient une section détaillant toutes les options. Gardez tout
de même une copie du fichier INI original, en cas de problème. Avec
le paramètre de ligne de commande /ini vous pouvez précisez un autre fichier
de configuration que PACIFIST.INI.
La première fois que vous allez utiliser PaCifiST, il y a quelques trucs
à changer dans la configuration selon votre système.
La chose la plus importante est d'indiquer à PaCifiST où trouver votre fichier
TOS. Charger le fichier INI avec un éditeur de texte and allez dans la section
[system]. Vous pouvez mettre des lignes en commentaires en plaçant un ";" en
début de ligne. Ensuite, indiquez le nom de votre fichier TOS (TOS image):
tos= tos162.img ;vous devez spécifier le chemin d'accès complet au fichier
;si il n'est pas dans le répertoire de PaCifiST.
Placez autant de clauses "TOS=" que vous avez de fichiers TOS, de façon à
pouvoir passer de l'un à l'autre pendant l'émulation. Le dernier spécifié
sera celui par défaut. Il est conseillé pour chaque clause TOS= de placer
aussi un court commentaire pour décrire le fichier, par exemple en donnant
la version du TOS, le pays d'origine, etc... par exemple:
tos= tos162.img, "TOS 1.62 (fr)"
Le fichier INI livré avec PaCifiST contient un exemple de configuration de TOS.
Assurez-vous aussi la première fois que tous les chemins dans les clauses
IMAGE et MOUNT sont valides.
3. Configuration
================
Il y a 3 niveaux de configuration. Le fichier INI contient les options
globales, tandis que les paramètres de ligne de commande n'affecte que la
session en cours. Enfin, certaines options peuvent être changées en cours
de route depuis le moniteur.
Un fichier appelé JOY.CFG sera aussi créé dans le répertoire de PaCifiST dès
que vous calibrerez un éventuel joystick.
3.1 Réferences des directives du fichier INI
--------------------------------------------
Les tabulations, espaces et le texte après ";" sont ignorés.
3.1.1 Section "System" (Système)
--------------------------------
TOS = <fichier>,"comnt" Nom du fichier TOS. Si plusieurs sont déclarés,
le dernier sera utilisé par défaut. Vous pouvez
passer d'un TOS à l'autre depuis le moniteur.
AUTORUN = [yes|no] Si YES (Oui), PaCifiST démarrera de suite
l'émulation, sans passer par le moniteur.
RAMSIZE = [n|512k] Spécifie la taille de la RAM (mémoire vive)
affectée à l'Atari ST émulé. Les valeurs
possibles sont de 1 à 14 Mo et 512k. Depuis
la version 0.47, vous pouvez également indiquer
des multiples de 0.5 (0.5, 2.5, etc...)
SOUND = [yes|no] Indique si vous voulez une émulation du son
ou non.
SAMPLES = [yes|no] Indique si vous voulez une (mauvaise) émulation
des sons digitalisés (logiciels) du STF
VOLUME = <n> Indique le volume sonore. Le maxi est 255, et
c'est également la valeur par défaut (il est
préférable de régler le son de manière externe).
MIDI = [yes|no] Emulation du MIDI OUT? Carte soundblaster
nécessaire, mais alors l'émulation de la
puce sonore n'est plus possible. [*NOUVEAU*]
INTERNALMOUSE=[yes|no] Le défaut est non. Mettez cette directive à
yes si vous rencontrez des problèmes de souris.
Cela ne marche *que* sous DOS.
SENSITIVITY=[1-10] Sensibilité de la souris (incompatible avec la
clause INTERNALMOUSE) de 1 à 10 (défaut 5).
MOUSECOM = [1|2] Dans le cas ou INTERNALMOUSE est mis à yes,
désigne le port série de votre souris.
SERIAL = [yes|no] Autorise/Supprime l'émulation du port série.
mieux vaut mettre à non: De toute façon ce
n'est pas encore près.
JOYSTICK = [yes|no] Demande à PaCifiST de ne pas utiliser de
joystick PC. Une émulation clavier est de
toute façon possible.
LAPTOP = [yes|no] Si à "yes", c'est l'autre touche CTRL qui sera
utilisée pour émuler le bouton de feu du
joystick. (option pour ordinateurs portables)
LEDS = [yes|no] Si à "yes" (défaut), la LED "scroll lock"
clignotera pour indiquer une activité du
lecteur de disquette du ST émulé.
KBDELAY = n Délai de réponse du clavier de 1 à 10 (défaut
3). Vous pouvez aussi changer cette valeur
depuis le moniteur. Le processeur clavier du
ST (6301) envoie des paquets d'information
au 68000. Ce paramètre permet de simuler un
délai entre chaque information des paquets.
IMAGE = <fichier>,drv Cette directive donne le nom d'un fichier
image de disquette devant être "insérée"
dans le lecteur A: ou B:
2 clauses IMAGE peuvent être utilisées
conjointement dans le fichier INI. Vous pouvez
également préciser un lecteur (A ou B) pour
forcer l'image dans un lecteur particulier.
MOUNT = <chemin absolu> Demande à l'émulateur de "monter" un répertoire
PC comme unité Atari. Le chemin précisé doit
être donné de façon absolue (depuis la racine,
par exemple MOUNT=C:\PACIFIST\STFILES).
PCDRIVE = [yes|no] PaCifiST doit-il utiliser le lecteur de
disquette du PC. Le Défaut (et la valeur
conseillé) est "no".
PARALLEL = [yes|no] Emulation du port parallèle ou non
STE = [yes|no] Emulation du shifter STE
3.1.2 Section "Screen" (Ecran)
------------------------------
MONOCHROME = [yes|no] Comme vous le devinez, PaCifiST doit-il émuler
un moniteur couleur ou monochrome.
FASTVIDEO = [yes|no] Mettre à "yes", surtout si votre carte vidéo
est lente. Cela n'est utile qu'en mode
d'émulation vidéo orientée-écran.
REFRESHRATE = <n> Le défaut est 1, ce qui veut dire que *tous*
les écran Atari sont converti en écran PC
(50 fois par seconde). Si votre PC est un lent,
vous pouvez mettre une autre valeur.
RENDER = [screen|line|mixed|custom]
Démarre PaCifiST dans un mode d'émulation
vidéo précis.
VBEMODE = [?|n] Donne le mode VBE à utiliser par défaut
en mode ligne. [*NOUVEAU*] cf 4.2
3.1.3 Section "Debug" (Déboggage)
---------------------------------
Ces paramètres ne sont guères utiles que pour moi, et ceux qui veulent un
peu "bidouiller": examiner les interruptions, les évenements clavier,
désassembler du code...
Vous devez impérativement posséder une version compilée "DEBUG" de l'émulateur
pour en tirer profit.
LOGFILE = <fichier> Nom d'un fichier de LOG où enregistrer
certaines informations plus ou moins
techniques.
TRAPIRQ = [all|none|v] Demande à PaCifiST de stopper l'exécution des
programmes quant une interruption se produit.
Le défaut est de n'en intercepter aucune.
"all" signifie toute ("none" aucune). Si le
nombre v est positif, cette exception est
rajoutée à la liste, s'il est négatif elle est
retirée. Vous pouvez spécifier une liste de
valeurs séparées par des virgules.
LOGIRQ = [all|none|v] Comme ci-dessus, mais PaCifiST se contentera
d'écrire un bloc d'information dans le fichier
de LOG sans interrompre l'exécution.
3.1.4 Exemple de fichier PACIFIST.INI
-------------------------------------
[system]
tos = c:\pacifist\tos.rom, "Mon TOS" ; donne le chemin d'accès au TOS
image=c:\pacifist\disks\boot.st ; nom d'un fichier image pour le lecteur ST A:
mount=c:\pacifist\stfiles ; C:\PACIFIST\STFILES deviendra C: pour le ST
mount=c:\pacifist\games ; C:\PACIFIST\GAMES deviendra D: pour le ST
autorun = no ; afficher le moniteur
pcdrive=no ; :) pas d'émulation dans le lecteur du PC
[video]
refreshrate = 2 ; n'émule qu'un écran de l'Atari sur deux
monochrome = no ; émulation d'un moniteur COULEUR
render=screen ; utiliser le rendu vidéo par écran
[debug] ; seulement si PaCifiST est compilé par DEBUG
; ignorez cette section
logfile = f:\debug.out ; le fichier de log où mettre les infos
logirq = none ; liste des exceptions vide
logirq = 0x21 ; logguer les appels à GEMDOS
logirq = 0x1c,69 ; logguer aussi les VBL & les TIMERS C
trapirq = 5 ; monitorer les divisions par zéros
3.2 Paramètres de la ligne de commande
--------------------------------------
PACIFIST [/option1] [/option2] [....]
Certaines directives du fichier INI peuvent être outrepassées sur la ligne
de commande. Les options valides sont:
/[h(elp)|?] liste des options
/ini <fichier> utilise le nom précisé plutot que PACIFIST.INI
/refreshrate n comme la directive REFRESHRATE
/mono [yes|no] comme la directive MONOCHROME
/autorun [yes|no] comme la directive AUTORUN
/ramsize [n|512k] comme la directive RAMSIZE
/sound [yes|no] comme la directive SOUND
/image <filename> désigne une image de disquette prioritaire
/mount <path> désigne un chemin à monter prioritairement
/maxspeed comment en mode "maxspeed" (vitesse maxi)
/pcdrive [yes|no] comme la directive PCDRIVE directive
/render [screen|line|mixed|custom] comme la directive RENDER
/ymrecord allocation mémoire pour l'enregistrement des YM
/vbemode [?|n] comme la directive VBEMODE
3.3 Configuration depuis le Moniteur
------------------------------------
Lisez la section de référence du Moniteur pour une description complète de
toutes les commandes. Si vous ne connaissez pas l'assembleur 68000, seules
les commandes suivantes vous serons directement utiles:
g "go", lancer l'émulation
x "eXit" quitter l'émulateur et revenir au DOS
vol <n> définie le volume (0-255)
help aide rapide
Touches utiles:
[F1] Changer entre les modes de rendu vidéo SCREEN (écran), LINE (lignes),
MIXED (mixte).
[F2] Choisir un mode vidéo utilisé en mode LINE (lignes). Disponible
seulement si un driver VBE2.0 avec mémoire vidéo linéaire est détecté
au démarrage. Les modes 256 couleurs sont les plus rapides, mais les
32k & 64k donnent de meilleurs résultat.
Le mode par défaut peut être précisé en utilisant la directive INI
(ou le paramètre de ligne de commandes) vbemode. [*NOUVEAU*] cf 4.2
[F3] Change le mode de vitesse (MAX/ST). Peu stable.
[F4] Affiche l'écran d'émulation joystick.
[F5] Emulation des sons digitalisés logiciels du STF
[F10] Change entre l'émulation MONO/COULEUR. Comme pour un vrai ST,
la machine émulée est réinitialisée. [*NOUVEAU*]
[F12] Affiche l'écran de sélection de disquette. On peut aussi utiliser
F12 *pendant* l'émulation.
3.4 L'écran de sélection de disquette
-------------------------------------
Utilisez F12 à tout moment pour afficher cet écran. Il est utilisé pour
changer les disquettes insérées dans les lecteurs A: & B: du ST émulé.
Le sélecteur n'affiche pas tous les fichiers, mais seulement ceux dont
l'extension est .ST, .MSA, .ZIP et .RAR ainsi que les répertoires
et les unités valides.
Utilisez ESC pour quitter l'écran. <HAUT>, <BAS>, <PAGE PREC.>, <PAGE SUIV.>,
<HOME>, <FIN> pour naviguer dans la liste de gauche. <TAB>, <DROITE>, <GAUCHE>
choisissent entre le lecteur de disquette A: & B. <ENTREE> insérera l'image
sélectionné dans le lecteur courant. Il y a également une option pour
virtuellement "l'enlever".
La touche <*> vous permet de forcer la non-exécution des bootsecteurs qui
sont normalement exécutables. Par défaut, PaCifiST est en mode 'KEEP BOOT'
(conserver le boot) mais en mode 'SKIP BOOT' (outrepasser le boot) il fera
croire a l'Atari qu'aucun boot n'est exécutable.
Pratique si une image de disquette contient un virus ST (inoffensif pour
votre PC!).
Bien sur, si la disquette insérée doit être bootée (pour qu'un jeu démarre),
il faut également effectuer un reset de l'Atari ST (CTRL-BREAK sous émulation,
ou commande 'reset' sous le Moniteur).
Le sélecteur de disquettes considère les archives ZIP & RAR comme des
répertoires conventionnels, vous pouvez dont grouper vos images de disquette
dans de tels archives. Les désarchiveurs PKUNZIP.EXE & RAR.EXE doivent se
trouver dans le chemin du DOS (ou le répertoire de PaCifiST) pour que cette
possibilité vous soit présentée. PaCifiST utilisera le répertoire temporaire
précisé dans la variable d'environnement TEMP pour ces extractions.
IMPORTANT: Aucune écriture effectuée sur une image MSA ou dans une archive
ne sera répercutée dans l'image originale.
3.5 L'écran des ports joysticks
-------------------------------
Cet écran vous permet de choisir entre différents types d'émulations pour
chacun des 2 ports joystick de l'Atari. Pour l'instant, seuls 3 choix sont
possibles: "none" (pas d'émulation), "PC Joystick #1" et "Numeric Pad" (pavé
numérique).
- PC Joystick #1 n'est disponible que si un joystick analogique a
été détecté au démarrage de l'émulateur. Vous devez également calibrer
cette manette: Tapez "c" depuis cet écran, ou "calib" sous le Moniteur.
- Le pavé numérique peut donc être utilisé pour simuler un joystick ST,
le voyant NumLock (VerrNum) doit alors être désactivé.
la touche CTRL de droite (ou gauche si laptop=yes dans le fichier INI)
sert de bouton de feu.
4. Divers
=========
4.1 Quelques Conseils
---------------------
- MIEUX VAUT NE PAS UTILISER DE CACHE DISQUE AVEC ECRITURE DIFFEREE
(genre SMARTDRV C+)
- Quelques fonctions du GEMDOS ne sont pas super bien émulées. Par
exemple sur les unités "mountées", le sélecteur de fichiers du
GFA BASIC ne marche pas bien.
- Si vous avez des difficultés à configurer PaCifiST, vous avez tout
intérêt à utiliser une "front-end interface" (interface de config),
un utilitaire spécialement créé dans ce but. Il en existe une
dizaine, dont AssiST sous DOS (Par Aengus Jankowsky) & PaCiLOAD
sous Windows 95 (par Andrew Knipe).
- Si vous utiliser une version "DEBUG" de PaCifiST et que vous avez
beaucoup de mémoire, placer le fichier de LOG dans un ramdisque.
- Eviter d'utiliser PCDRIVE. C'est lent, peu stable et bien moins
pratique qu'une image de disquette.
4.2 Le VBE 2.0
--------------
Pour que le mode de rendu vidéo par ligne (LINE MODE) donne toute sa mesure,
mieux vaut disposer d'un driver VBE 2.0, comme par exemple Scitech's
Display Doctor (http://www.scitechsoft.com), un shareware.
Si vous posséder une carte graphique basée sur une puce de la famille S3,
il existe également S3VBE par D.Meschede qui lui est gratuit.
[*NOUVEAU*]: Vous pouvez changer le mode VBE2.0 utilisé par défaut en mode
LINE au démarrage, en utilisant la directive INI "vbemode". D'abord il
faut créer un fichier listant les modes autorisés. Pour cela ayez
"vbemode=?" dans PACIFIST.INI (ou démarrez l'émulateur avec /vbemode ?)
Un fichier VBEMODES.LST est créé, ressemblant à ca:
--- PaCifiST authorized VBE Modes ---
0x0163 320 200 8
0x0164 320 240 8
0x014f 400 300 8
0x010d 320 200 15
0x012e 320 240 15
0x0137 320 400 16
0x0138 320 480 16
Bien sur, ce sera différent d'une configuration à une autre. La première
colonne indique le nom du mode, puis on trouve les résolutions X et Y,
puis le nombre de bits par couleurs (8 pour 256 colors, 15 pour 32000,
16 pour 65000).
Donc si vous voulez le mode 320x240 en 256 couleurs par défaut en mode
LINE, il faut avoir "vbemode=0x0164" dans le fichier INI.
4.3 Images de disquettes
------------------------
Ces fichiers ne contiennent juste que les secteurs d'une vraie disquette
mis les uns à la suite des autres dans l'ordre logique.
PaCifiST n'a pas besoin d'informations particulières, parce que les paramètres
de la disquette (nombre de secteurs, pistes...) sont contenus dans le premier
secteur. Si ces valeurs semblent erronées, PaCifiST tentera de les deviner
au mieux.
Vous pouvez créer vos propres fichiers images à partir de vos disquettes
ST par le programme IMGBUILD. Il vous permet également de créer des images
vierges de tailles diverses. Reportez-vous à la section RESSOURCES pour
plus d'informations.
PaCifiST est également capable d'utiliser directement des fichiers au
format MSA.
4.4 Correspondances pour le clavier
-----------------------------------
Le clavier pendant l'émulation correspond à celui d'un Atari réel, excepté:
- HELP est mappé sur PagePrec
- UNDO est mappé sur PageSuiv
- CTRL+Break fait un reset (+SHIFT pour un reset à froid)
- En émulation joystick, si NumLock est on, les touches flechées
correspondent aux directions de la manette de jeux (CTRL = feu),
F12 ramène au premier plan l'écran de sélection de disquette.
La touche en dessous ECHAPE ramène le Moniteur.
4.5 Captures d'écran
--------------------
Cette possibilité est apparue dans la version 0.44 de PaCifiST. Elle vous
permet d'enregistrer l'image actuellement à écran dans un fichier PCX
créé dans le répertoire de PaCifiST. Tous les fichiers seront appelés
"PCST_xxx.PCX"
Vous avez juste à presser la touche "Arrêt Défil" (ScrollLock), mais ce n'est
pas possible dans tous les modes vidéos.
* modes suppportés:
- Haute résolution du ST
- Basse résolution en SCREEN MODE
- Basse résolution en LINE MODE (256 & Hicolor)
- MIXED MODE (depuis PaCifiST v0.45)
* non supportés:
- Moyenne résolution du ST
4.6 Sauvegarde de jeux
----------------------
Le formatage dans PaCifiST est feint puisqu'il ne modifie pas la structure
des images de disquettes. Vous pouvez donc formater des disques de sauvegarde
pour certains jeux (voir ci-dessous), a condition que vous utilisiez des
images prévues pour: Même nombre de faces, de pistes et de secteurs par piste.
Exemples:
CARRIER COMMAND - Disquette double face, 10 secteurs
[imgbuild /blank /name SAVE.ST /sector 10]
DEUTEROS - Disquette standard (double face, 9 secteurs)
[imgbuild /blank /name SAVE.ST)
4.7 Enregistrement de musiques .YM
----------------------------------
If you know PaCifiST, then you're likely to know STSound as well.
STSound (DOS & Win95 version exist) is a software YM2149 emulator. Virtually
all ST soundchips (as well as Spectrum & Amstrad CPC ones) can be replayed.
This program is written by Arnaud Carre, and you can download the latest
version at: http://www.mygale.org/09/leonard/.
PaCifiST can now record such soundfiles. You must start the emulator with the
/ymrecord switch to allocate the needed extra memory (20 minutes of sound).
Use the "record" option under the monitor to start/stop the recording.
Files starting from YM_001.BIN will be created. BEWARE: Existing files are
overwritten without any warning.
Those files are "raw recorded" and huge. You should then use the LHA
archiver with a commandline like: lha a -h0 -m <ym file.ym> <raw file.bin>
to generate the final YM files
- PaCifiST can only record plain soundchips. Not Sampled ones.
The YM5! format is now used.
- Record only in ST speed. Don't worry if PaCifiST is under the 8Mhz,
it doesn't affect the replaying speed of the tune later on.
- Don't spread widely unperfect/uncomplete .YM files. Starting the
recording exactly when the music starts is not always easy and
some knowledge in music ripping may help.
With v0.46, you can use the <play> monitor command in order to
locate the exact start/end point in the music. A loop point can
also be specified.
- Read the DOC that comes with STSOUND.
4.7.1 Utilisation
-----------------
You start/stop the recording under the monitor:
record : display status
record on : start/resume recording
record off : stop/pause record. You then choose between:
(F)ree - free the recording memory, abort current record.
(P)ause - pause the recording.
(S)ave - save to a file called YM_xxxx.BIN.
4.7.2 Informations Techniques
-----------------------------
Use a DEBUG build of PaCifiST, to have the ability to set breakpoints,...
The best method is to locate the installation & replay routines. Look the
VBL & the MFP Timer vectors (command "status"), set a breakaccess at
"ff8802", etc...
The YM registers are recorded during the first rasterline. You must start
the recording just after the replay routines is called for the first time.
This will work most of the time:
1) find the installation routine
2) set a breakpoint at its end
3) go till then, remove the breakpoint.
4) use the command "trap 1c" (stop emulation on VBL)
5) "g" - go till the first VBL IRQ since music is installed
(repeat this twice in some cases)
6) "trap 1c", remove VBL trapping
"record on", start recording
7) if the music ends itself, stop recording, it's done. The end.
If it loops, you'd better wait the second complete rolling before
stopping. Then use YMTOOL in order to create an *exact* looped YM,
but it's not always possible.
4.8 Detection & Utilisation de PaCifiST
---------------------------------------
Il est maintenant possible aux programmes ST de détecter la présence de
PaCifiST. Dans le future des registres "hardware" supplémentaires sont
susceptibles d'être ajoutés. ;-)
Vous avez juste à appeler la fonction XBIOS Vsync() avec les registres
D6 & D7 étant "Emu?". Si votre programme est exécuté depuis PaCifiST, alors
D6 deviendra "PaCi" et D7 "fiST", A0 pointera vers le début d'une zone
mémoire spéciale (probablement $FFFF8100). Vous avez intérêt à être en
mode superviseur pour accéder à cette zone, même si ce n'est pas nécessaire
POUR LE MOMMENT.
L'émulateur TOSBOX de Mark Slagell utilise la même méthode de détection.
Reportez-vous au fichier EMUDTECT.TXT pour davantage d'information et
un exemple de source assembleur.
4.9 Freezing/Unfreezing [*NOUVEAU*]
-----------------------
Apparu dans la version 0.48 de PaCifiST, ces 2 commandes du moniteurs ("fz"
pour FreeZe et "uz" pour UnfreeZe) permettent de littéralement geler la
machine émulée et son contexte de manière à la restaurer plus tard.
Limitations:
============
ATTENTION!!! CES DEUX COMMANDES PEUVENT PLANTER VOTRE PC MECHAMMENT SI
VOUS N'Y PRENEZ PAS GARDE. En particulier ne les employez JAMAIS lorsque
PaCifiST utilise des partitions "mountées". De même, tout le contexte n'est
pas restauré, par exemple les images de disquette (.ST et .MSA) ne seront
pas insérées dans les lecteurs, ce sera *A VOUS* de le faire.
Il ne faudra donc JAMAIS freezer lors des chargements.
Les fichiers freezés ne seront surement pas compatibles entre 2 versions
de PaCifiST!
Vous devez IMPERATIVEMENT utiliser le même TOS entre un freeze et un
unfreeze, car il n'y a pas de changement automatique.
Dans la version 0.48, les fichiers FRZ sont très gros, dans le futur il
le seront bien moins. Evitez donc de freezer lorsque vous avez plus de
1 Mo de RAM émulée!
Utilisation:
============
Sous le moniteur, la commande "fz" attend 2 paramètres, le premier étant
obligatoire: le nom du fichier qui sera créé (8 caractères, sans extension).
A la suite, vous avez la possibilité de taper un commentaire. Par exemple:
fz sent197 The Sentinel, level 197
Va créer un fichier SENT197.FRZ. Pour le recharger plus tard:
uz sent197
Pour voir la liste des fichiers FRZ (avec leurs commentaires):
uz
5. Le Moniteur
==============
5.1 L'écran du Moniteur
-----------------------
La barre bleu tout en haut de l'écran contient un mini rappel des touches de
fonctions les plus utiles, ainsi que les modes d'émulation vidéo et de vitesse
en cours.
En dessous se trouve le contenu des registres du 68000, une estimation de la
vitesse relative de l'émulation ainsi que la ligne raster actuelle.
Sur la droite: Le contenu de la pile courante (USP ou SSP), une liste des
breakpoints (points d'arrêts), breakaccesses (accès d'arrêts), breakopcode
(opcode d'arrêt).
La fenêtre du haut montre en permanence un désassemblage des instructions
68000 autour du PC. Un "*" placé devant une instruction indique un breakpoint
à cet adresse.
Vous pouvez utiliser CTRL-Z pour tracer une instruction (step into), CTRL-T
faisant la même chose sans entrer dans les sous-programmes (trace over).
CTRL-U peut être utilisé quand le mode trace du 68000 est actif, pour passer
chaque instruction. PaCifiST permet en effet de "tracer le mode trace".
CTRL-G est une alternative à la commande <go>.
5.2 Les commandes du Moniteur
-----------------------------
Certaines commandes nécessitent une version "DEBUG" de PaCifiST. Parce que
cela ralentit l'émulation, elle n'est pas inclus dans les distributions
normales de l'émulateur.
Les paramètres entre parenthèses sont optionnels.
[*NOUVEAU*] Avec la version 0.48, vous pouvez utiliser des expressions
mathématiques dans les commandes.
h,help,? Rapide résumé des commandes
t Trace une instruction à la fois, exceptés les BSR, JSR & TRAP
qui sont exécutés complètement (appuyez sur une touche pour
interrompre cette exécution).
z (n) Trace une seule instruction. Si une interruption se produit,
elle sera déclenchée immédiatement. Le mode trace peut
également être tracé.
d (adr) désassemblage sur quelques lignes
g (n) "go". Exécution, lancer l'émulation.
m (adr) affiche un dump de la mémoire (hexa & ascii).
bp (adr) ajoute ou enlève un point d'arrêt. Cela ne modifie pas du tout
la mémoire, vous pouvez placer un breakpoint AVANT même qu'une
routine ne soit chargée à cette adresse. Evitez d'utiliser
des points d'accès comme première instruction d'une routine
d'exception (mieux vaut alors se servir de la commande TRAP).
ba (adr) ajoute ou enlève un breakaccess (accès d'arrêt). Toute lecture
ou écriture à cette adresse particulière interrompra
l'émulation. Attention: un accès d'un mot à $10000 ne
déclenchera pas un accès d'arrêt à $10001.
bar/baw (adr) [*NOUVEAU*] Déclenche les breakaccesses seulement en lecture
ou en écriture.
bo <msk> <cmp> définit un opcode d'arrêt (break opcode). Un seul utilisable.
Tous les opcodes sont ANDés avec le premier paramètre puis
comparés avec le second. Par exemple <bo ffff 4e75> stoppera
l'émulation à chaque instruction RTS rencontrées. Pour supprimer
le breakopcode, utilisez <bo 0 1>.
e <expression> evaluation d'une expression
s reg=<value> Change la valeur d'un registre 68000.
s [adr]=<octet> change la mémoire (même la ROM). Par exemple "s [1230] = 4e 71"
mettra un $4e en $1230 et un $71 en $1231.
nop <adr> <n> Remplit la mémoire à <adr> avec <n> instructions NOP.
lb <nom> <adr> (taille) charge un fichier en mémoire.
sb <nom> <adr> <taille> sauve une partie de la mémoire sur disque.
reset (hard) Effectue un RESET du ST émulé. (+hard pour reset à froid)
trap (vecteur) Cette commande vous permet de stopper l'émulation 68000 quand
se produit une exception de numéro donné. TRAP seul donne
une liste des vecteurs importants de l'Atari ST.
animate <n> Cette commande trace <n> instructions, en écrivant dans le
fichier de LOG défini dans PACIFIST.INI le contenu des
registres 68000 à chaque pas.
status Affiche des informations sur le MFP & les lecteurs ST.
disa <debut> <fin> Désassemble une partie de la mémoire.
kbd (octets) Affiche ou ajoute des octets dans le buffer interne du 6301.
kbdelay [n] Examine ou change la valeur de la variable KBDVALUE
vol (volume) définit le volume (de 0 à 255), ou affiche le volume actuel.
x eXit. Retour au DOS.
pref [on|off] Si "on" (activé), le prefetch du 68000 sera émulé. Cela ralenti
beaucoup l'émulation, aussi mieux vaut n'entrer dans ce mode
que temporairement, quand nécessaire (pour passer le boot de
la BIG DEMO par exemple)
patch [off|...] Change le comportement normal de PaCifiST pour passer certains
programmes. Le seul patch actif actuellement est "joy". Essayez
le quand le bouton du joystick ne semble pas marcher.
calib Entrer dans le monde de calibration du joystick PC.
tos changer le TOS actuel, si plusieurs ont été listés dans le
fichier INI. Bien sur le ST est reseté.
record [on|off] Enregistrement de musique YM. PaCifiST doit avoir été lancé
avec le switch /ymrecord. Si aucun argument n'est donné,
le statut actuel de l'enregistrement est affiché.
Si la commande <play> a été utilisé avant, les paramètres
éventuellement spécifiés alors sont utilisés.
play <start> <end> <loop> rejoue le buffer YM.
fz <nom> [commentaire] freeze le contexte du ST émulé [*NOUVEAU*] Attention:
Lisez bien le paragraphe 4.9 avant d'utiliser cette option.
uz [nom] Affiche la liste des fichiers FREEZE ou restaure le
contexte du ST émulé [*NOUVEAU*]
Les commandes suivantes nécessitent une version "DEBUG" de PaCifiST:
bp, ba, bar, baw, bo, trap
5.3 Evaluateur d'expressions [*NOUVEAU*]
----------------------------
Au lieu de taper "d 4000" pour désassembler à $4000, vous avez maintenant
la possibilité de passer des expressions mathématiques comme paramètres,
par exemple (a0+d0)*2
Opérateurs Supportés: + * - / == > < && || & | ^ ~ >> << ( )
Les nombres sont par défaut héxadécimaux, mais les registres 68000 étant
évalués, a7 n'est pas le nombre décimal +167 mais le poiteur de pile. Pour
forcer le contraire, utilisez $A7. Des nombres décimaux peuvent être
entrés, si précédés de # ou \.
Des références à la mémoire sont possible, en utilisant [] pour un mot
long. Par exemple "d [70]" désassemblera la routine VBL. [].b ou [].w
désignera seulement un octet ou un mot.
6. Ressources & Remerciements
===============================
6.1 Programmes connexes
-----------------------
6.1.1 Autres émulateurs
-----------------------
- STonX Ecrit par Marinos Yannikos(nino@complang.tuwien.ac.at)
et Martin Griffiths (mgriffiths@ea.com).
Il s'agit d'un émulateur freeware pour Unix livré sous
forme de sources. Une version DOS existe également,
portage réalisé par Dirk Jansen. Le site officiel est:
http://www.complang.tuwien.ac.at/nino/home.html
LA homepage de la version DOS est hébergée par
EmuCamp, le site de Zoop!
- Gemulator 96 Il s'agit d'un émulateur commercial. Il est rapide mais
ne peut utiliser que des applications Atari ST 100%
systèmes. Gemulator Classic, plus vieux et sous DOS
est quant à lui gratuit. Site officiel:
http://www.emulators.com
- NoSTalgia C'est un émulateur très récent, écrit par Philippe
Gerin (philippe.gerin@advalvas.be). Il est conçu pour
MAC (PPC et 68000 dans sa dernière version)
et semble particulièrement bon.
http://users.skynet.be/sky39147/
- TOSBOX Un émulateur ST tout nouveau, utilisable sous DOS.
Son auteur, Mark Slagell (bald_soprano@usa.net), a
bien travaillé: TOSBOX est basée sur une émulation
du système. De ce fait, lui et PaCifiST sont tout
à fait complementaires.
- WINSTON Le plus récent de la liste. Comme son nom le laisse
entendre, il fonctionne sous Windows. Dès sa
première version, cet émulateur était déjà très
bon, il a donc un avenir radieux. Homepage:
http://www.winston.fatal-design.com
6.1.2 Utilitaires
-----------------
AssiST - Aengus Jankowsky (ajankows@iol.ie)
http://homepages.iol.ie/~ajankows/st/assist/assist.html
Un utilitaire qui configure PaCifiST pour vous par l'intermediaire
d'un menu très clair. Ce programme est recommandé aussi bien pour les
novices que les habitués de la scène de l'émulation.
Une version Windows95 remplace AssiST à présent: AssiST97! Réalisée
par Aengus et Gerard Butterly.
PaCiLOAD - Andrew Knipe (alk@bluesky.net.au)
http://www.labyrinth.net.au/~contact/paciload.zip
Une interface de configuration sous Windows. Facile à utiliser,
elle peut également convertir des fichiers .MSA vers .ST avant de
démarrer de l'émulateur.
MSAtoST - Damien Burke (st@jetman.demon.co.uk)
STtoMSA http://www.jetman.demon.co.uk/st/index.html
deux convertisseurs pour faire passer les fichiers MSA en ST et
vice-versa. De nombreux programmes Atari ST sur Internet sont
sous forme d'archives MSA.
IMGBUILD - Frederic Gidouin (frederic.gidouin@hol.fr)
http://www.pacifist.fatal-design.com/
Un petit utilitaire pour créer des fichiers images .ST à partir
de vraies disquettes. Il ne peut pas lire les disquettes 11 secteurs
ni les formats exotiques.
ImgBuild peut aussi créer des images "vierges".
Désolé, par manque de courage, de temps et de place cette liste est très
incomplète. D'autres utilitaires existent:Fuji Bar, PaCifiGUI, PaCigo 97
(et maintenant 98), MSA2ST, MakeDisk, ParaLink, PaCifiST Dragon.
Reportez-vous à la page Internet de PaCifiST pour Plus d'infos.
6.2 Ressources
--------------
PaCifiST-Support Sites:
=======================
- http://www.pacifist.fatal-design.com/
La page officielle de PaCifiST. Vous y trouverez les dernières
infos, version de l'émulateur & plein de liens.
programmation HTML & design du site faits par Rich!!
- Demonburps Emporium [http://ireland.iol.ie/~ajankows/st/pacifist.html]
Contient plusieurs versions de PaCifiST et de AssiST. Quelques
images de disquettes (jeux), des TOS et des liens.
Aengus a été un pionnier dans la scene de l'émulation ST avec son
site web.
- The Little Green Desktop [http://www.fatal-design.com/desktop/]
Un incroyable site, plein de bonnes idées. Il est maintenu par
Rich(ard) Davey a qui la communauté de l'émulation ST doit une
fière chandelle: FujiBBS, archives de centaines d'images de
disquettes, liste de diffusion sur PaCifiST...
- http://www.geocities.com/SiliconValley/Park/9967/
- http://www.jetman.demon.co.uk/st/index.html
- http://www.geocities.com/SiliconValley/Park/5000/index.html
- http://www.geocities.com/SiliconValley/Lakes/8711/
- http://users.iol.it/mamo7
- http://home.pages.de/~stefansworld/pacifist/st_page.htm
- http://www.geocities.com/area51/corridor/8458/
- http://www.geocities.com/SiliconValley/Way/8264/index.html
- http://users.powernet.co.uk/sterling/pacifist/
- http://dspace.dial.pipex.com/chriscox/home.htm
- http://hem.passagen.se/win95/index.htm
- http://www.ohz.north.de/user/ruediger/home.htm
Autres Pages Web
================
- http://www.mygale.org/09/leonard/
La page de Arnaud Carré, présentant notamment son incroyable STSOUND,
un player capable entre autre d'émuler à la perfection la puce sonore
YM2149. Des centaines de musiques au format .YM sont disponibles.
- http://www.why.net/home/adam/cem/toc.html
La FAQ de comp.emulators.misc, maintenue par Adam Roach.
6.3 REMERCIEMENTS
-----------------
Je voudrais remercier tout particulièrement les personnes suivantes pour leur
soutien & leur feedback.
Darren Birks
Damien Burke
Arnaud Carre
Stuart Campbell
Jan Alexander Corsini
Chris Cox
Richard Davey
Ulrich Doewich
Laurent Fargues
Flix
Ben Fozard
Peter Fransson
Philippe Gerin
Carolyn Horn
Aengus Jankowsky
Johan Klockars
Andrew Knipe
Patrice Lindivat
Bruno Mathieu
Jonathan McHugh
Mike Mee
Stefan Meier
Andreas Muegge
Ludovic Olivencia
Ed Olmos
Jamison Pitcher
Matthew Prest
Alan Reeve
Mauro Rossetti
Mark Slagell
Simone Voltolini
Arsene Von Wyss
Zoop
Et bien sûr un GRAND MERCI à toutes les personnes qui m'ont encouragé par des
contributions matérielles.
Le logo utilisé en en-tête de cette doc a été dessiné par Senser de
Nitrophusion (merci!).
Merci à Emmanuel Loyon pour son évaluateur d'expression, sur lequel est
basé celui de PaCifiST.
6.4 POUR ME CONTACTER
---------------------
N'hesitez pas à me contacter pour si vous avez des suggestions, des
remarques ou...des dons à faire!
adresse électronique:
frederic.gidouin@hol.fr
adresse postal:
Frederic Gidouin
9, Allee du Chevrefeuille
29280 Plouzane
FRANCE